home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / zfunction.z / zfunction
Encoding:
Text File  |  2002-10-03  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. zzzzffffuuuunnnnccccttttiiiioooonnnn((((3333GGGG))))                                                    zzzzffffuuuunnnnccccttttiiiioooonnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      zzzzffffuuuunnnnccccttttiiiioooonnnn - specifies the function used for z-buffer comparison by the
  10.      current framebuffer
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd zzzzffffuuuunnnnccccttttiiiioooonnnn((((ffffuuuunnnncccc))))
  14.      lllloooonnnngggg ffffuuuunnnncccc;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _f_u_n_c   expects one of eight possible flags used when comparing z values.
  18.             The available flags are:
  19.  
  20.             ZZZZFFFF____NNNNEEEEVVVVEEEERRRR, the z-buffer function never passes.
  21.  
  22.             ZZZZFFFF____LLLLEEEESSSSSSSS, the z-buffer function passes if the incoming pixel _z
  23.             value is less than the _z value stored in the z-buffer bitplanes.
  24.  
  25.             ZZZZFFFF____EEEEQQQQUUUUAAAALLLL, the z-buffer function passes if the incoming pixel _z
  26.             value is equal to the _z value stored in the z-buffer bitplanes.
  27.  
  28.             ZZZZFFFF____LLLLEEEEQQQQUUUUAAAALLLL, the z-buffer function passes if the incoming pixel _z
  29.             value is less than or equal to the _z value stored in the z-buffer
  30.             bitplanes.  (This is the default value.)
  31.  
  32.             ZZZZFFFF____GGGGRRRREEEEAAAATTTTEEEERRRR, the z-buffer function passes if the incoming pixel _z
  33.             value is greater than the _z value stored in the z-buffer
  34.             bitplanes.
  35.  
  36.             ZZZZFFFF____NNNNOOOOTTTTEEEEQQQQUUUUAAAALLLL, the z-buffer function passes if the incoming pixel _z
  37.             value is not equal to the _z value stored in the z-buffer
  38.             bitplanes.
  39.  
  40.             ZZZZFFFF____GGGGEEEEQQQQUUUUAAAALLLL, the z-buffer function passes if the incoming pixel _z
  41.             value is greater than or equal to the _z value stored in the z-
  42.             buffer bitplanes.
  43.  
  44.             ZZZZFFFF____AAAALLLLWWWWAAAAYYYYSSSS, the z-buffer function always passes.
  45.  
  46. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.      zzzzffffuuuunnnnccccttttiiiioooonnnn specifies the function used to compare each incoming pixel _z
  48.      value with the _z value present in the z-buffer bitplanes.  For example,
  49.      if _f_u_n_c is ZF_LESS and the incoming pixel _z value is less than the _z
  50.      value in the z-buffer bitplanes, the comparison passes.  Refer to the
  51.      zzzzbbbbuuuuffffffffeeeerrrr manual page for an explanation of z-buffer operation in the cases
  52.      of z function pass and failure.
  53.  
  54.      A separate zzzzffffuuuunnnnccccttttiiiioooonnnn mode is retained by each of the framebuffers:
  55.      normal, popup, overlay, and underlay.  The current draw mode determines
  56.      which z function value is used, and which is modified by zzzzffffuuuunnnnccccttttiiiioooonnnn.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. zzzzffffuuuunnnnccccttttiiiioooonnnn((((3333GGGG))))                                                    zzzzffffuuuunnnnccccttttiiiioooonnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      drawmode, zbuffer, zsource
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      Currently z-buffer operation is supported only in the normal framebuffer.
  79.      To insure compatibility with future releases of the GL, make calls to
  80.      zzzzffffuuuunnnnccccttttiiiioooonnnn only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  81.  
  82.      On the Personal Iris, if you use zzzzffffuuuunnnnccccttttiiiioooonnnn with cccczzzzcccclllleeeeaaaarrrr you can increase
  83.      the speed of buffer clearing.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.